Document ownership for return value of gtk_file_chooser_get_file()

diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c
index c8078b12a5e23cd4d63c3d73e994e5a982713e9f..6c7de57225d2aa4eea9fab6b4b67145e8223122e 100644 (file)
--- a/gtk/gtkfilechooser.c
+++ b/gtk/gtkfilechooser.c
@@ -1239,7 +1239,8 @@ gtk_file_chooser_set_file (GtkFileChooser  *chooser,
  * If the file chooser is in folder mode, this function returns the selected
  * folder.
  *
- * Returns: a selected #GFile
+ * Returns: a selected #GFile. You own the returned file; use
+ *          g_object_unref() to release it.
  *
  * Since: 2.14
  **/